Tranzakció eredményének lekérdezése a kereskedő oldalán

A kereskedő transactionReference vagy paymentReference segítségével képes lekérdezni a tranzakció részleteit.

Kizárólag csak az egyik azonosító szerepelhet a kérésben.

Végpontok

EAM tranzakció státusz lekérdezés transaction vagy payment reference alapján:

POST {BaseURL}/v1/ofo/eam/query

Megjegyzés

Amennyiben a start hívás során a paymentMethods tömbben EAM szerepel, ezt a végpontot kell hívni. Az EAM az online fizetési oldal megnyitása (átirányítás után) azonnal legenerálódik és lekérdezhető. Ezt a végpontot használják EAM tranzakció status lekérdezésre a korábbi onlinefizetes-v1 /query-by-transaction-reference végpontól, mivel a régi 2026 januárban törlésre kerül. Az átálláshoz elég a PATH-t módosítani, RTP lekérdezésre pedig másik PATH van.

RTP tranzakció státusz lekérdezés kizárólag csak transaction reference alapján:

POST {BaseURL}/v1/ofo/rtp/query

Megjegyzés

Amennyiben a start hívás során a paymentMethods tömb tartalmazza az RTP értéket, akkor ezt a végpontot kell használni. Az RTP fizetés esetén a vásárlónak meg kell adnia a számlaszámát vagy egy másodlagos azonosítót, majd a „Fizetés kérelem küldése” gombra kell kattintania. Csak ezt követően jön létre a tranzakció. Fontos hangsúlyozni, hogy a redirect URL megnyitása után további vásárlói interakció szükséges, így a tranzakció nem érhető el azonnal lekérdezésre. A redirect URL megnyitását követő polling a beküldött tranzakcióazonosítóval kezdetben 404-es HTTP státuszkódot ad vissza.

Header:

Mező	Típus	Leírás
Signature	srting (hex)	a fent leírt módon generált HMAC signature
X-Request-ID	string (uuid)	kereskedő által UUID sémában kiosztott egyedi hívásazonosító, mely az adott hívást azonosítja
X-Correlation-ID	string (uuid)	kereskedő által UUID sémában kiosztott egyedi munkamenet-azonosító, mely a teljes munkamenetet azonosítja

Body:

Mező	Típus	Leírás
idempotencyKey	string (uuid)	kereskedő által kiosztott UUID formátumú egyedi kód
technicalUserId	string	az API felhasználó technikai azonosítója (pl. 10234)
transactionReference	string	a payment start hívásban megadott egyedi tranzakció-azonosító kód
paymentReference	string	aggregátortól kapott fizetési azonosító, kizárólag EAM tranzakció lekérdezésénél használható, az eam/query végponton
timestamp	string	a kérés összeállításának időbélyege datetimeoffset formátumban (pl. 2024-10-04T14:23:45Z)

Példa:

{ 
  "idempotencyKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 
  "technicalUserId": "string", 
  "transactionReference": "string", 
  "timestamp": "2024-10-15T10:14:26.121Z" 
} 

Response

{ 
    "salt": "TzRxZ+VpvtSv0WAH/OUCe6FBjNwhGqIevYXTjEHTv2s=", 
    "status": "EXPIRED" 
} 

A status értékei az alábbiak lehetnek:

Státusz	Leírás
RECEIVED	A beérkezett validált hibamentes kérés RECEIVED státuszt kap, RECEIVED: egy új payment (URL) létrehozása esetén keletkezik ez az induló státusz
CANCELLED	A kedvezményezett visszavonta az EAM-ot. Visszavonni csak olyan EAM-ot lehet, aminek fizetése még nem teljesült.
PAYMENT_ATTEMPTED	Elutasítva a fizetési kezdeményezés, de megismételhető. A megváltozott státusz azt mutatja, hogy korábban már volt fizetési próbálkozás. (A QR kód banki alkalmazásba történő beolvasása még nem minősül próbálkozásnak.)
ACCEPTED	Az azonnali átutalás sikeresen megtörtént, a kért összeg megérkezett a kedvezményezett számlájára.
EXPIRED	Nem történt státuszváltozás a megadott lejárati időn belül, így a payment státusza EXPIRED-re vált.
REJECTED	A tranzakció validációs problémák miatt elutasításra került, így a fizetés nem teljesült.